home *** CD-ROM | disk | FTP | other *** search
/ Amiga Developer CD v2.1 / Amiga Developer CD v2.1.iso / CDTV / cdtvtools-20 / setcdfs / SetCDFS.doc < prev    next >
Text File  |  1992-02-14  |  4KB  |  91 lines
  1. SetCDFS                                                               SetCDFS
  2.  
  3.    NAME
  4.         SetCDFS -- Set CD filesystem options in an ISO-9660 image file.
  5.  
  6.    SYNOPSIS
  7.         SetCDFS { -[dblfresnot] | +[dblfr]# | +[esnot] } <file> [ file ... ]
  8.  
  9.    FUNCTION
  10.         This program sets a number of configuration options in an ISO-9660
  11.         disc image file, which are read by CDTV at boot time.  These options
  12.         are specific to CDTV.
  13.  
  14.         The program operates on any number of files; the same options are
  15.         applied to all files supplied.  The option switches are specified
  16.         below.  If the option is preceeded by a '+', then the option and its
  17.         associated parameter, if any, are added to the ISO image.  If the
  18.         option is preceeded by a '-', the option, if present, is removed
  19.         from the ISO image.
  20.  
  21.         If no options are specified, the options currently within each ISO
  22.         image file are printed.
  23.  
  24.         The available options are:
  25.  
  26.         d#:     Sets the size of the directory cache, in disc blocks.  Each
  27.                 block is 2K.
  28.  
  29.         b#:     Sets the size of the read-ahead cache, in disc blocks.  Each
  30.                 block is 2K.
  31.  
  32.         l#:     Sets the size of the FileLock cache.  The value is the
  33.                 number of FileLocks to allocate.
  34.  
  35.         f#:     Sets the size of the FileHandle cache.  The value is the
  36.                 number of FileHandles to allocate.
  37.  
  38.         r#:     Sets the number of times to retry a disc read.
  39.  
  40.         e:      Turns on/off direct reads.  CDTV defaults to non-direct
  41.                 reads due to a bug in the DMA controller (see the
  42.                 CDTV.device docs for more details).  However, if your
  43.                 software is aware of this and compensates, you can re-enable
  44.                 direct reads with this flag.
  45.  
  46.         s:      Enables/disables fast directory searches.  ISO-9660 mandates
  47.                 that filenames in a directory be sorted in ASCII order, but
  48.                 doesn't specify sorting order for filenames that mix upper-
  49.                 and lower-case.  If this option is enabled, CDTV will search
  50.                 directories case-insensitively, stopping when it has either
  51.                 found the file, or passed the point where the file could be.
  52.  
  53.                 If you use this option, you should be sure your mastering
  54.                 software sorts directories case-insensitively.
  55.  
  56.         o<name>:
  57.                 Installs a BootFile.  If installed, the named file is loaded
  58.                 and run shortly after disc insertion, well before
  59.                 Startup-Sequence.  This can be useful for creating "fast
  60.                 start" titles that don't require the filesystem.
  61.  
  62.                 (This option is not currently implemented.)
  63.  
  64.         t[name]:
  65.                 Installs CDTV trademark information.  If 'name' is
  66.                 specified, the trademark data is taken from the named file.
  67.                 Otherwise, the default name "CDTV.TM" is used.
  68.  
  69.                 (This option is not currently implemented.)
  70.  
  71.         The various caches and buffers are allocated by the filesystem well
  72.         before Startup-Sequence happens.  Naturally, these buffers should be
  73.         tuned to suit your specific application.  If your title is an
  74.         encyclopedia, you might benefit from having larger directory and
  75.         FileLock caches.  On the other hand, if you're making extensive use
  76.         of CD-XL, which bypasses the filesystem, smaller cache sizes may be
  77.         to your advantage to reclaim memory.
  78.  
  79.    EXAMPLE
  80.         SetCDFS +d4 +b4 ISOFile   ; Set 4 dir blocks, 4 read blocks
  81.         SetCDFS -e +s image       ; Disable direct reads, enable fast search
  82.         SetCDFS Other_Image       ; Print options in 'Other_Image'
  83.  
  84.    BUGS
  85.         SetCDFS currently does not work properly under Kickstart 1.3 or
  86.         Workbench 1.3.
  87.  
  88.  
  89.  
  90.  
  91.